package com.zliblike_platform.mapper;

import com.zliblike_platform.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * 用户Mapper接口
 */
@Mapper
public interface UserMapper {
    
    /**
     * 根据用户ID查询用户信息
     * @param id 用户ID
     * @return 用户信息
     */
    User selectById(@Param("id") Long id);
    
    /**
     * 根据用户名查询用户信息
     * @param username 用户名
     * @return 用户信息
     */
    User selectByUsername(@Param("username") String username);
    
    /**
     * 根据邮箱查询用户信息
     * @param email 邮箱
     * @return 用户信息
     */
    User selectByEmail(@Param("email") String email);
    
    /**
     * 插入新用户
     * @param user 用户信息
     * @return 影响行数
     */
    int insert(User user);
    
    /**
     * 更新用户信息
     * @param user 用户信息
     * @return 影响行数
     */
    int update(User user);
    
    /**
     * 更新用户密码
     * @param id 用户ID
     * @param password 新密码
     * @return 影响行数
     */
    int updatePassword(@Param("id") Long id, @Param("password") String password);
    
    /**
     * 更新用户积分
     * @param id 用户ID
     * @param points 积分变化量
     * @return 影响行数
     */
    int updatePoints(@Param("id") Long id, @Param("points") Integer points);
    
    /**
     * 获取用户的每日下载限制
     * @param id 用户ID
     * @return 每日下载限制
     */
    Integer getDailyDownloadLimit(@Param("id") Long id);
    
    /**
     * 获取用户当日已下载次数
     * @param id 用户ID
     * @return 已下载次数
     */
    Integer getUserDailyDownloads(@Param("id") Long id);
    
    /**
     * 检查用户是否存在
     * @param id 用户ID
     * @return 是否存在
     */
    boolean existsById(@Param("id") Long id);
    
    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsByUsername(@Param("username") String username);
    
    /**
     * 检查邮箱是否存在
     * @param email 邮箱
     * @return 是否存在
     */
    boolean existsByEmail(@Param("email") String email);
    
    /**
     * 更新用户等级
     * @param id 用户ID
     * @param level 新的用户等级
     * @return 影响行数
     */
    int updateUserLevel(@Param("id") Long id, @Param("level") Integer level);
} 